home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3dm / audiofile / AFinitmarkname.z / AFinitmarkname
Encoding:
Text File  |  1998-10-20  |  5.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4. aaaaffffIIIInnnniiiittttMMMMaaaarrrrkkkkNNNNaaaammmmeeee((((3333ddddmmmm))))                                        aaaaffffIIIInnnniiiittttMMMMaaaarrrrkkkkNNNNaaaammmmeeee((((3333ddddmmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      afInitMarkName, afInitMarkComment - initialize the name/comment for a
  10.      specified marker in an AAAAFFFFffffiiiilllleeeesssseeeettttuuuupppp structure
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////aaaauuuuddddiiiiooooffffiiiilllleeee....hhhh>>>>
  14.  
  15.      vvvvooooiiiidddd aaaaffffIIIInnnniiiittttMMMMaaaarrrrkkkkNNNNaaaammmmeeee((((AAAAFFFFffffiiiilllleeeesssseeeettttuuuupppp sssseeeettttuuuupppp,,,, iiiinnnntttt ttttrrrraaaacccckkkk,,,, iiiinnnntttt mmmmaaaarrrrkkkkiiiidddd,,,,
  16.                                       ccccoooonnnnsssstttt cccchhhhaaaarrrr ****nnnnaaaammmmeeeessssttttrrrr))))
  17.  
  18.      vvvvooooiiiidddd aaaaffffIIIInnnniiiittttMMMMaaaarrrrkkkkCCCCoooommmmmmmmeeeennnntttt((((AAAAFFFFffffiiiilllleeeesssseeeettttuuuupppp sssseeeettttuuuupppp,,,, iiiinnnntttt ttttrrrraaaacccckkkk,,,, iiiinnnntttt mmmmaaaarrrrkkkkiiiidddd,,,,
  19.                                       ccccoooonnnnsssstttt cccchhhhaaaarrrr ****ccccoooommmmmmmmssssttttrrrr))))
  20.  
  21. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRR
  22.      _s_e_t_u_p     is an AAAAFFFFffffiiiilllleeeesssseeeettttuuuupppp structure, previously created by a call to
  23.                aaaaffffNNNNeeeewwwwFFFFiiiilllleeeeSSSSeeeettttuuuupppp(3dm).
  24.  
  25.      _t_r_a_c_k     is a positive integer value which specifies an audio track in a
  26.                file configuration.
  27.  
  28.                Since all currently supported file formats contain exactly one
  29.                audio track, the value AAAAFFFF____DDDDEEEEFFFFAAAAUUUULLLLTTTT____TTTTRRRRAAAACCCCKKKK should always be used
  30.                here for now.
  31.  
  32.      _m_a_r_k_i_d    a positive integer value which identifies a marker structure
  33.                configured into _t_r_a_c_k previously by aaaaffffIIIInnnniiiittttMMMMaaaarrrrkkkkIIIIDDDDssss(3dm).
  34.  
  35.      _n_a_m_e_s_t_r   is a character string which will be written into the marker
  36.                structure when an audio file is created with _s_e_t_u_p.
  37.  
  38.                AIFF-C (AIFF) files allow up to 255 characters per marker name.
  39.  
  40.      _c_o_m_m_s_t_r   is a character string which will be written into the marker
  41.                structure when an audio file is created with _s_e_t_u_p.
  42.  
  43.                Any file type which does not allow comments (AIFF-C and AIFF
  44.                included) will simply ignore the comment.  Currently, WAVE
  45.                files support comments in the "cue" list, into which the mark
  46.                chunks are mapped.
  47.  
  48. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  49.      aaaaffffIIIInnnniiiittttMMMMaaaarrrrkkkkNNNNaaaammmmeeee(((()))) specifies a name string for a marker structure.
  50.      aaaaffffIIIInnnniiiittttMMMMaaaarrrrkkkkCCCCoooommmmmmmmeeeennnntttt(((()))) specifies a comment string for same. Note that you
  51.      need to initialize a list of marker ID's for _s_e_t_u_p by calling
  52.      aaaaffffIIIInnnniiiittttMMMMaaaarrrrkkkkIIIIDDDDssss(3dm) before you can set name strings and/or comments for
  53.      individual markers.
  54.  
  55.      When you create an audio file by passing _s_e_t_u_p to aaaaffffOOOOppppeeeennnnFFFFiiiilllleeee(3dm), the
  56.      file header will be written out with _n_a_m_e_s_t_r attached to the marker
  57.      structure given by _m_a_r_k_i_d.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. aaaaffffIIIInnnniiiittttMMMMaaaarrrrkkkkNNNNaaaammmmeeee((((3333ddddmmmm))))                                        aaaaffffIIIInnnniiiittttMMMMaaaarrrrkkkkNNNNaaaammmmeeee((((3333ddddmmmm))))
  71.  
  72.  
  73.  
  74.      Marker names and comments default to zero-length strings.
  75.  
  76. EEEEXXXXAAAAMMMMPPPPLLLLEEEE
  77.      You might initialize the marker ID list in an AAAAFFFFffffiiiilllleeeesssseeeettttuuuupppp to {1,2,3,4} to
  78.      store four endpoints, two for each of two loops.
  79.  
  80.      You might then give marker 1 the name "begin sustain loop", marker 2 the
  81.      name "end sustain loop", marker 3 the name "begin release loop", and
  82.      marker 4 the name "end release loop".
  83.  
  84. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  85.      afNewFileSetup(3dm), afOpenFile(3dm), afInitMarkIDs(3dm),
  86.      afGetMarkIDs(3dm), afGetMarkName(3dm)
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.